package com.miniapp.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.miniapp.entity.Role;
import com.miniapp.domain.vo.RoleQueryVO;

import java.util.List;

/**
 * 角色Service接口
 *
 * @author yourname
 * @date 2025-09-08
 */
public interface RoleService extends IService<Role> {

    /**
     * 根据用户ID查询角色编码列表
     *
     * @param userId 用户ID
     * @return 角色编码列表
     */
    List<String> getUserRoleCodes(Long userId);

    /**
     * 根据用户ID查询角色ID列表
     *
     * @param userId 用户ID
     * @return 角色ID列表
     */
    List<Long> getUserRoleIds(Long userId);

    /**
     * 分页查询角色列表
     *
     * @param queryVO 查询参数
     * @return 角色列表
     */
    IPage<Role> queryRolePage(RoleQueryVO queryVO);

    /**
     * 保存角色
     *
     * @param role 角色实体
     * @return 是否成功
     */
    boolean saveRole(Role role);

    /**
     * 更新角色
     *
     * @param role 角色实体
     * @return 是否成功
     */
    boolean updateRole(Role role);

    /**
     * 分配用户角色
     *
     * @param userId  用户ID
     * @param roleIds 角色ID列表
     * @return 是否成功
     */
    boolean assignUserRoles(Long userId, List<Long> roleIds);
}